home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Add-Ons / MPW / MPW noweb 2.7 / src / c / readme.nw < prev    next >
Encoding:
Text File  |  1995-05-30  |  2.0 KB  |  61 lines  |  [TEXT/MPS ]
  1. % Copyright 1991 by Norman Ramsey.  All rights reserved.
  2. % See file COPYRIGHT for more information.
  3. Guidebook.
  4.  
  5. Here's a breakdown of files by function.
  6.  
  7. columns.nw      Used to help accumulate indentations across module
  8.                 boundaries by measuring the widths of various strings
  9.                 in columns.  Depends on your notion of tabs.
  10.  
  11. errors.nw       Functions that issue error messages.
  12.  
  13. getline.nw      Used to read text a line at a time, no matter how
  14.                 long lines might be.
  15.  
  16. main.nw         Process options and so on before calling notangle.
  17.  
  18. markup.nw       Encapsulates all the definitions of how things are
  19.                 labeled in the text: what is a module definition,
  20.                 what terminates it, and so on.
  21.  
  22. modtrees.nw     Provides a table of modules with insert and lookup
  23.                 (no delete).  Also can apply an arbitrary function
  24.                 to each module in the table.
  25.  
  26. modules.nw      Defines the abstraction of a module and the operations
  27.                 on it.
  28.  
  29. notangle.nw     Reads a text on one file and writes a program on another.
  30.                 Works by reading module definitions, then expanding
  31.                 the module ``*''.
  32.  
  33. strsave.nw      Return a pointer to a fresh copy of a string.
  34.  
  35.  
  36. @ History of features.
  37.  
  38.  2 Feb 89:  improve the visual quality of the output by removing the trailing
  39.             newline from every module and by tracking indentation.
  40.  
  41.  9 Feb 89:  parameterize notangle by the name of the root module, and
  42.             make it a command line option.  This will help in writing
  43.             multiple outputs from a single input.
  44.  
  45. 21 Mar 89:  Make markup front end for noweave and notangle.
  46.             This breaks passing of options for notangle.
  47.             Tough.
  48.  
  49.             Much improved cleanliness of implementation.
  50.  
  51. ?? ??? 90:  Track string locations for emitting \#line pragmas
  52.  
  53. Summer 91:  Version 2: second syntax for tools, added noroots.
  54.  
  55.  
  56. @ Bugs.
  57. There's no distinction between errors and warnings.
  58.  
  59. Also see the man page.
  60. <<*>>=
  61.